home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / ox / readme < prev    next >
Text File  |  1994-10-29  |  5KB  |  132 lines
  1. This message contains instructions for obtaining Ox G1.04.
  2. Installation according to these procedures requires a Unix system
  3. with ftp, uncompress, yacc, lex, and a C compiler.  If these
  4. instructions won't work for you, please write to the address at
  5. the end of this message.
  6.  
  7. The available Ox-related items are as follows:
  8.  
  9.      * oxDistG1.04.sh.Z: Ox G1.04 Distribution Package.  This is
  10.      a compressed sh script of size about 900 kilobytes.
  11.      Installation requires about 3 megabytes of disk space.  This
  12.      package includes:
  13.  
  14.           * source code for Ox G1.04.
  15.  
  16.           * Ox Tutorial Introduction (about 18 pages) in LaTeX
  17.           .dvi and Postscript format.
  18.  
  19.           * Ox User Reference Manual (about 57 pages) in LaTeX
  20.           .dvi and Postscript format.
  21.  
  22.           * Ox on-line manual entry.
  23.  
  24.           * Ox programs for several toy evaluators.
  25.  
  26.           * Ox program for a compiler for a C-like (but block-
  27.           structured) imperative programming language.  Includes
  28.           66-page description in Postscript format.  Suitable for
  29.           instruction and experimentation.
  30.  
  31.           * Ox grammars for parsers for popular languages.  Most
  32.           of these are taken from an archive site mentioned in
  33.           the comp.compilers monthly message.  They included
  34.           Yacc, Lex, and C source code and `make' files that
  35.           cause preprocessing by Ox.  Each is a CFG ready for
  36.           augmentation with attribute definitions.  Included are
  37.           attribute-grammars-to-be for:
  38.  
  39.                * ANSI C
  40.                * C++
  41.                * ANSI Pascal
  42.                * FORTRAN 77 subset
  43.                * ANSI Ada
  44.  
  45.      * oxTestG1.04.sh.Z:  Ox Test Suite.  This is a compressed sh
  46.      script of size about 750 kilobytes.  Exercising Ox G1.04 on
  47.      the test suite requires about 8.5 megabytes of disk space.
  48.      This has been executed in several diverse hardware/software
  49.      environments, but if you can spare this much space
  50.      temporarily, it is a good idea to run these tests on your
  51.      system.
  52.  
  53. Here is how to obtain any of the above:
  54.  
  55.      Type `ftp ftp.cs.iastate.edu' or `ftp 129.186.3.15' at the
  56.      prompt on your machine.
  57.  
  58.      Type `anonymous' when prompted for a username.
  59.  
  60.      Type your e-mail address when prompted for a password.
  61.  
  62.      Type `binary' at the ftp prompt to put ftp in binary mode.
  63.  
  64.      Type `cd pub/ox' at the ftp prompt to get to the right
  65.      directory.
  66.  
  67.      To copy the above-described files to your machine, type one
  68.      or more of the following at the ftp prompt:
  69.  
  70.           get oxDistG1.04.sh.Z
  71.  
  72.           get oxTestG1.04.sh.Z
  73.  
  74.      Type `quit' at the ftp prompt to exit ftp.
  75.  
  76. To unpack the Ox G1.04 distribution package, issue the following
  77. command sequence at your system prompt:
  78.  
  79.       cp oxDistG1.04.sh.Z oxDistG1.04.sh.Z.bak
  80.              # makes a backup
  81.       uncompress oxDistG1.04.sh.Z
  82.              # overwrites oxDistG1.04.sh
  83.       sh oxDistG1.04.sh
  84.              # overwrites oxDistG1.04
  85.       rm oxDistG1.04.sh
  86.              # removes clutter
  87.  
  88. To unpack the Ox G1.04 test suite, issue the following command
  89. sequence at your system prompt:
  90.  
  91.       cp oxTestG1.04.sh.Z oxTestG1.04.sh.Z.bak
  92.              # makes a backup
  93.       uncompress oxTestG1.04.sh.Z
  94.              # overwrites oxTestG1.04.sh
  95.       sh oxTestG1.04.sh
  96.              # overwrites oxTestG1.04
  97.       rm oxTestG1.04.sh
  98.              # removes clutter
  99.  
  100. To use the contents of the distribution package (most
  101. importantly, to install Ox G1.04 on your machine), `cd
  102. oxDistG1.04' and follow the instructions in that directory's
  103. README file.
  104.  
  105. If you have completed the installation of Ox G1.04, and followed
  106. the above instructions for downloading and unpacking the test
  107. suite, you can test Ox G1.04 on your machine by doing `cd
  108. oxTestG1.04' and following the instructions in the README file
  109. there.
  110.  
  111. If the above procedures won't work for you (for instance, if you
  112. lack `ftp' or `uncompress'), the material can be sent by e-mail
  113. or on diskette--please send mail describing your situation to:
  114.  
  115.       ox-request@cs.iastate.edu
  116.  
  117. *****************************************************************
  118.        Ox source code and documentation are copyrighted:
  119.  
  120.        Copyright (c) 1992, 1993, 1994  Kurt M. Bischoff
  121.                       All rights reserved.
  122.  
  123. Public distribution of Ox (for instance, placing it on an
  124. anonymous-ftp archive or on a CD-ROM) requires permission from
  125. the author.
  126.  
  127. THIS SOFTWARE IS PROVIDED FOR USE "AS IS" AND WITHOUT ANY EXPRESS
  128. OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  129. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  130. PURPOSE.
  131. *****************************************************************
  132.